package com.szgz.platform.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.szgz.platform.model.TaskStepCompletion;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 任务步骤完成记录Mapper接口
 */
@Mapper
public interface TaskStepCompletionMapper extends BaseMapper<TaskStepCompletion> {

    /**
     * 分页查询用户的步骤完成记录
     *
     * @param page 分页参数
     * @param userId 用户ID
     * @param taskId 任务ID（可选）
     * @param stepId 步骤ID（可选）
     * @param status 完成状态（可选）
     * @return 分页结果
     */
    IPage<TaskStepCompletion> selectUserCompletions(Page<TaskStepCompletion> page,
                                                   @Param("userId") Long userId,
                                                   @Param("taskId") Long taskId,
                                                   @Param("stepId") Long stepId,
                                                   @Param("status") String status);

    /**
     * 查询用户在指定任务中的步骤完成情况
     *
     * @param userId 用户ID
     * @param taskId 任务ID
     * @return 完成记录列表
     */
    List<TaskStepCompletion> selectUserTaskCompletions(@Param("userId") Long userId,
                                                      @Param("taskId") Long taskId);

    /**
     * 查询指定步骤的用户完成记录
     *
     * @param stepId 步骤ID
     * @param status 完成状态（可选）
     * @return 完成记录列表
     */
    List<TaskStepCompletion> selectStepCompletions(@Param("stepId") Long stepId,
                                                  @Param("status") String status);

    /**
     * 查询用户在指定步骤的完成记录
     *
     * @param userId 用户ID
     * @param stepId 步骤ID
     * @return 完成记录
     */
    TaskStepCompletion selectUserStepCompletion(@Param("userId") Long userId,
                                              @Param("stepId") Long stepId);

    /**
     * 查询用户在指定任务的完成进度
     *
     * @param userId 用户ID
     * @param taskId 任务ID
     * @return 完成进度统计
     */
    TaskStepCompletion selectUserTaskProgress(@Param("userId") Long userId,
                                            @Param("taskId") Long taskId);

    /**
     * 统计用户在指定任务的完成步骤数量
     *
     * @param userId 用户ID
     * @param taskId 任务ID
     * @param status 完成状态
     * @return 完成步骤数量
     */
    int countUserCompletedSteps(@Param("userId") Long userId,
                               @Param("taskId") Long taskId,
                               @Param("status") String status);

    /**
     * 查询用户最近完成的步骤
     *
     * @param userId 用户ID
     * @param limit 限制数量
     * @return 最近完成的步骤列表
     */
    List<TaskStepCompletion> selectUserRecentCompletions(@Param("userId") Long userId,
                                                        @Param("limit") Integer limit);

    /**
     * 查询步骤的完成统计信息
     *
     * @param stepId 步骤ID
     * @return 统计信息
     */
    TaskStepCompletion selectStepCompletionStats(@Param("stepId") Long stepId);

    /**
     * 批量插入或更新完成记录
     *
     * @param completions 完成记录列表
     * @return 影响行数
     */
    int batchInsertOrUpdate(@Param("completions") List<TaskStepCompletion> completions);

    /**
     * 删除用户的步骤完成记录
     *
     * @param userId 用户ID
     * @param stepId 步骤ID
     * @return 影响行数
     */
    int deleteUserStepCompletion(@Param("userId") Long userId, @Param("stepId") Long stepId);

    /**
     * 重置用户在指定任务的步骤完成状态
     *
     * @param userId 用户ID
     * @param taskId 任务ID
     * @return 影响行数
     */
    int resetUserTaskCompletions(@Param("userId") Long userId, @Param("taskId") Long taskId);
} 